API Direct Debit - Payment Refund

Berfungsi untuk melakukan pengembalian dana

Service Info

HTTP Method	POST
Service Code	58
Http Method	POST
Path	...{version}/debit/refund

Header

Header Name	Tipe Data	Wajib	Deskripsi
Content-Type	String	Y	application/json
Authorization	String	Y	Token B2B
Authorization-Customer	String	Y	Token B2B2C
X-TIMESTAMP	String	Y	Waktu lokal klien saat ini dalam format yyyy-MM-ddTHH:mm:ss+07:00.
X-SIGNATURE	String	Y	Dibuat dengan algoritma asymmetric with token B2B2C: Signature Generation
X-PARTNER-ID	String	Y	Client’s client_id (diberikan pada saat onboarding )
X-EXTERNAL-ID	String	Y	Nomor referensi yang harus unik pada hari yg sama
CHANNEL-ID	String	Y	00001 untuk PJP and 00002 untuk non PJP

Body

Parameter	Tipe Data	Wajib	Deskripsi
merchantId	String	Y	Kode unik yang dimiliki setiap user Length: <= 64 karakter
originalPartnerReferenceNo	String	Y	ID Transaksi milik partner Length: <= 64 karakter
originalReferenceNo	String	Y	Id transaksi SpeedCash Length: <= 64 karakter
partnerRefundNo	String	Y	Kode refund milik partner / id transaksi milik partner Length: <= 64 karakter

Request samples

JSON

{
  "merchantId": "121xxxx",
  "originalPartnerReferenceNo": "2020102900000000000001",
  "originalReferenceNo": "5037424",
  "partnerRefundNo": "1234123215"
}

CURL

curl --location --request POST '../v1.0/debit/refund' \
--header 'X-TIMESTAMP: 2023-01-27T13:51:00+07:00' \
--header 'X-SIGNATURE: RwABEherf+3MTBhIf6vtju6ko+YOFFKWLGgHCD5RwX1I17JCKVn8ffc/TenEIly85InhuIcKCDqDrxbIBhaKEg==' \
--header 'X-PARTNER-ID: 085224a9-4b42-4f7d-959f-4452f8a9a1ff' \
--header 'X-EXTERNAL-ID: 024a31b6-e0c8-429a-9d41-83a2f44b6844' \
--header 'X-DEVICE-ID: android-20013adf6cdd8123f' \
--header 'CHANNEL-ID: 12345' \
--header 'Authorization: Bearer bb005fcb-dea9-499a-9e7a-bcf651b2334e' \
--header 'Authorization-Customer:Bearer 5b8bbaf8-4aca-4072-9ea8-d85bed65105f' \
--header 'Content-Type: application/json' \
--data '{
    "merchantId": "121xxxx",
    "originalPartnerReferenceNo": "2020102900000000000001",
    "originalReferenceNo": "5037424",
    "partnerRefundNo": "1234123215",
}'

```

Response Structure

Parameter	Tipe Data	Deskripsi
responseCode	String	Kode respons Length: <= 7 karakter
responseMessage	String	Deskripsi respons Length: <= 150 karakter
referenceNo	String	Pengidentifikasi transaksi asli pada penyedia layanan Length: <= 64 karakter
refundNo	String	Pengidentifikasi transaksi pengembalian pada sistem konsumen layanan Length: <= 32 karakter
partnerRefundNo	String	Nomor referensi dari PJP AIS untuk pengembalian Length: <= 2 karakter
refundTime	String	Tanggal pengembalian transaksi dalam format ISO 8601 Length: <= 25 karakter

Response samples

{
  "responseCode": "2005800",
  "responseMessage": "Successful",
  "referenceNo": "5037424",
  "refundNo": "12321322",
  "partnerRefundNo": "1237218936",
  "refundTime": "2023-01-27T17:28:00.667+07:00"
}

List Response Code API Direct Debit - Payment Refund

Response Code	Response Message	Description
2005800	Success	Sukses
4005801	Invalid field format { field name }	Format invalid
4005802	Invalid mandatory field {field name}	Format pada bidang wajib tidak ada atau tidak valid
4015800	Unauthorized. Invalid Signature	X-Signature salah
4015801	Invalid Token, Token found in request is invalid	Token B2B invalid
4015802	Invalid Customer Token, Token found in request is invalid	Token B2B2C invalid
4095800	Cannot use same X-EXTERNAL-ID in same day	X-External-ID sudah pernah digunakan di hari yang sama
4045801	Bad Request	Request header ada yang salah / kurang
4045801	Unauthorized. Client Forbidden Access API	Partner tidak dapat mengakses api terkait